Skip to content

Update the README files and also add the default value for the temporary directory parameter.#278

Merged
cwlacewe merged 6 commits intodevelopfrom
fix/277_Update_the_README_files_set_default_tmp_dir
Apr 8, 2025
Merged

Update the README files and also add the default value for the temporary directory parameter.#278
cwlacewe merged 6 commits intodevelopfrom
fix/277_Update_the_README_files_set_default_tmp_dir

Conversation

@rolandoquesada
Copy link
Copy Markdown
Contributor

The changes done to the code apply for the issue: #277

@rolandoquesada rolandoquesada requested review from cwlacewe and rv355 April 3, 2025 07:33
1. Copy the `remote_function` directory on the machine you want to run the remote server. Can be run on any location, independent of where VDMS is running. However, the location should be reachable from the machine that is running VDMS. You can also use `sparse-checkout` to only retrieve the `remote_function` directory from the VDMS repo.
2. Create the operation scripts as python scripts and place them in the `remote_function/functions` directory.
4. Follow the following steps to run the remote on port <port_number>.
2. Copy `resources` directory (located at the root of the repository) next to the `remote_function` directory.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For clarification, when you say next to should the resources directory be copied into the remote_function directory? So resulting directory would be remote_function/resources? If this is correct, I suggest changing it to:

Suggested change
2. Copy `resources` directory (located at the root of the repository) next to the `remote_function` directory.
2. Copy `resources` directory (located at the root of the repository) into the `remote_function` directory.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Chaunté, the "resources" and "remote_function" directories should be siblings.
As they are siblings directories, could you please tell me if I should clarify that or if the use of "next" could confuse to the reader?
Thank you.

Copy link
Copy Markdown
Contributor

@cwlacewe cwlacewe Apr 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rolandoquesada, I'm was a little confused with the next to term. When you say sibling directories, they should be in same parent directory? So say we have parent/remote_function, then the resources path should be parent/resources? If so, I suggest:

Suggested change
2. Copy `resources` directory (located at the root of the repository) next to the `remote_function` directory.
2. Copy `resources` directory (located at the root of the repository) into the same directory as the `remote_function` directory.

What do you think?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The suggestion by @cwlacewe sounds good.

Otherwise, you can include the resources directory copy instruction in Step 1 if it still sounds confusing. So you say, "Copy the remote_function and resources directories on the machine you want to run the remote server. Both should be in the same parent directory. It can be on any server, independent of where VDMS is running. However, the server should be reachable from the machine that is running VDMS."


1. Copy `remote_function` directory to your remote server machine. Say the address is `my.remote.server` and you copy the folder in the `home` directory. The folder structure you have now will look something like this;
1. Copy `remote_function` directory to your remote server machine. Say the address is `my.remote.server` and you copy the folder in the `home` directory.
2. Copy `resources` directory (located at the root of the repository) next to the `remote_function` directory. The folder structure you have now will look something like this;
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment as Setup section


1. Copy `user_defined_operations` directory to anywhere you want but on the same server that is running VDMS. Say you copy the folder in the `home` directory. The folder structure you have now will look something like this;
1. Copy `user_defined_operations` directory to anywhere you want but on the same server that is running VDMS. Say you copy the folder in the `home` directory.
2. Copy `resources` directory (located at the root of the repository) next to the `user_defined_operations` directory. The folder structure you have now will look something like this;
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Copy `resources` directory (located at the root of the repository) next to the `user_defined_operations` directory. The folder structure you have now will look something like this;
2. Copy `resources` directory (located at the root of the repository) into the `user_defined_operations` directory. The folder structure you have now will look something like this;

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Chaunté, the "resources" and "user_defined_operations" directories should be siblings.
As they are siblings directories, could you please tell me if I should clarify that or if the use of "next" could confuse to the reader?
Thank you.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @cwlacewe and @rv355, as Rohit and I discussed by chat, I modified the README files to explain that the resources directory should be copied into the corresponding remote_function or user_defined_operations directory. Also, I modified the steps so the user can follow that approach.
Please let me know if you see any issues or if you have any suggestions.
Thank you

@rolandoquesada rolandoquesada requested a review from cwlacewe April 3, 2025 08:11
rv355
rv355 previously approved these changes Apr 3, 2025
1. Copy the `remote_function` directory on the machine you want to run the remote server. Can be run on any location, independent of where VDMS is running. However, the location should be reachable from the machine that is running VDMS. You can also use `sparse-checkout` to only retrieve the `remote_function` directory from the VDMS repo.
2. Create the operation scripts as python scripts and place them in the `remote_function/functions` directory.
4. Follow the following steps to run the remote on port <port_number>.
2. Copy `resources` directory (located at the root of the repository) next to the `remote_function` directory.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The suggestion by @cwlacewe sounds good.

Otherwise, you can include the resources directory copy instruction in Step 1 if it still sounds confusing. So you say, "Copy the remote_function and resources directories on the machine you want to run the remote server. Both should be in the same parent directory. It can be on any server, independent of where VDMS is running. However, the server should be reachable from the machine that is running VDMS."

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 3, 2025

Target CPP Coverage: 64.2075%
Source CPP Coverage: 64.1978%

Target Python Coverage: 97.94%
Source Python Coverage: 97.94%

@cwlacewe
Copy link
Copy Markdown
Contributor

cwlacewe commented Apr 3, 2025

@rolandoquesada I like @rv355's suggestion better

@rolandoquesada rolandoquesada requested a review from rv355 April 4, 2025 06:05
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 4, 2025

Target CPP Coverage: 64.2075%
Source CPP Coverage: 64.2075%

Target Python Coverage: 97.94%
Source Python Coverage: 97.94%

cwlacewe
cwlacewe previously approved these changes Apr 4, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2025

Target CPP Coverage: 64.2075%
Source CPP Coverage: 64.2075%

Target Python Coverage: 97.94%
Source Python Coverage: 97.94%

@cwlacewe cwlacewe merged commit de64149 into develop Apr 8, 2025
8 checks passed
@cwlacewe cwlacewe added this to the v2.11.0 Tasks milestone Apr 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants